Star Rating Element
The Star Rating Element lets users quickly and easily rate a particular experience using a star rating system (with a 1-star rating being the lowest, and a 5-star rating being the highest). When a Star Rating Element has been added to the form, at runtime, five stars will be displayed within the Element, from which the user can select one:
For whichever star is selected (apart from the first star), the star or stars to the immediate left of the selection will also be selected, so that if, for example, the user selects the middle star (to give a rating of 3 out of 5 stars), both the first and second star will also be selected. One of the stars can be configured to be pre-selected/to act as the default, as discussed below.
Once you have placed a Star Rating Element on a page, you can edit the Element's properties to configure the Element for your requirements. Select the Element on the page to display its properties in the Properties Pane.
The following properties are available:
Element Version
The Element's version number, which may be (and is often) different to the installed version of the Digitise Forms software. For example, the version of the Element might be 1.5, but the version of the in-use/installed Digitise Forms software might be 2.0 etc.
Label
Allows you to change the text displayed in the label for this Element. You can change the default label to provide a more meaningful description or option for your users.
Visible and Disabled Properties
Show Label
Lets you show or hide the Element's label at form runtime. To hide the label so that the facial expressions only are displayed, deselect this option.
Size
Allows you to specify the size of the stars. The options available are Small, Medium, and Large.
Layout
Allows you to specify the position/alignment of the stars within the Element. The options available are Left, Right, Center, and Space Between. The first three options are fairly self-explanatory, but for Space Between, the stars will be spread evenly across the full width of the Element, with an equal amount of white space between them, as shown below:
The properties in this section allow you to specify validation criteria for the Element.
Value
Contains the selected value for the Star Rating Element. A number corresponding to one of the five available star ratings can be chosen from a list to act as the default/pre-selected option, using the up and down arrows at the right-hand side of the property. The list contains the values 0 (for no star rating selected), and 1 to 5 (for the number of stars selected). Alternatively, you can specify an input mapping to read the default/pre-selected value in from a Datasource, but no stars will be selected at runtime if the value isn't between 1 and 5 (inclusive).
For more information about mapping properties to data items in a Datasource see Data Tab Properties.
